home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / utility / utilfile / ccb.lha / CCB / CCB.text < prev    next >
Text File  |  1996-08-04  |  19KB  |  399 lines
  1. Short:    GUI for archivers LhA,LZX,DMS,DSQ v2.1
  2. Uploader: johnw@kvnet.org (John Wells)
  3. Author:   johnw@kvnet.org (John Wells)
  4. Type:     util/arc
  5. Replaces: util/arc/ccb.lha
  6.  
  7.                        Compressor Control Box - v2.1
  8.                               August 4, 1996
  9.                                by John Wells
  10.  
  11.  
  12. This  program  is Copyright 1996 by John Wells.  All Rights Reserved.  This
  13. program  may  not  be sold, although a small charge for shipping, handling,
  14. and media may be charged.
  15.  
  16.                                INTRODUCTION
  17.  
  18. This  program  is  a  convenient  interface  for  using   several disk/file
  19. archivers.    Currently,  Compressor  Control  Box (hereafter known as CCB)
  20. supports the following archivers: LZX, LHA, DMS, and DSQ.
  21.  
  22. First, a disclaimer:
  23.  
  24. The  purpose  of  this program is to compress the contents of floppy disks,
  25. hard  drives, and other forms of temporary and permanent computer storage. 
  26. The  author,  John  Wells,  will  not be held responsible for any data lost
  27. through the (correct or incorrect) use of this program, nor will he be held
  28. responsible for any damages (financial or otherwise) resulting from the use
  29. of this program.
  30.  
  31. General Info:
  32.  
  33. Ok, so what are these compressors?  Quick summary.  LhA is an archiver that
  34. takes  groups  of  files  and compresses them into one single file, thereby
  35. reducing  the  total size and making it easier to store said files.  LZX is
  36. the  latest  generation  file-archiver,   featuring   faster   and   better
  37. compression  than  LhA.    DMS  is  an archiver designed to compress entire
  38. disks,  resulting  in  a  single file that is easier to store and transfer.
  39. DSQ (short for DiskSqueeze!), is the modern-era disk compressor.  Dirk Vael
  40. originated  the concept with DiskSqueeze!, and I was hooked.  More reliable
  41. than  DMS,  it  also features better compression, using LZX and PackDev.  I
  42. have not done a full implementation of DiskSqueeze!  here, for that, please
  43. get  the  original  by  Dirk  Vael.   Look on Aminet under util/arc for the
  44. latest version.
  45.  
  46. Requirements:
  47.  
  48. I'm not sure, but I don't think CCB will run on pre-2.04 systems.   I don't
  49. know anyone still using 1.3!  It does work on 2.04 thru 3.1
  50.  
  51. DMSDescript (v1.1)         View/Add File_id.diz to DMS files
  52. PackDev (v1.7)             (De)Compress DiskSqueeze!  files
  53. DirII (v3.3)            Create Files.dsq for DiskSqueeze! 
  54. DMS (v1.11+)         *    (De)Compress DMS files
  55. LhA (v1.38e+)         *    Manipulating LHA files
  56. LZX (v1.20e+)         *    Manipulating LZX and DiskSqueeze! files
  57.  
  58.                             (* - Not Included)
  59.  
  60. In  order  to use the supported archivers, it is important that CCB be able
  61. to find them.  A good place for them is your C: directory.
  62.  
  63. CCB has been extensively tested using the following: LhA v1.38e and v1.50r,
  64. LZX  v1.20e, and DMS v1.11.  I would think that any newer versions of those
  65. programs would work just fine as well.
  66.  
  67. CCB also requires the cando.library, v2.511+, which is NOT included in this
  68. distribution, as I am not sure of the distributability (is that a word?) of
  69. the library.  However, since v3.006 of the library IS freely distributable,
  70. I have included it to make the package complete.
  71.  
  72. To make things a bit easier, just click on the included INSTALL icon to put
  73. the  included  programs  (DMSDescript,  DirII,  and  PackDev)  in  your  C:
  74. directory.
  75.  
  76. ToolTypes:
  77.  
  78. CCB currently supports the following tooltypes:
  79.  
  80. SOURCE=<default source path>              Default is SOURCE="Files:"
  81. DESTINATION=<default destination path>  Default is DESTINATION="DH1:Temp"
  82. TDIR=<default Temporary T: path>          Default is TDIR="DH1:T"
  83. VIEWER=<default text viewer>              Default is VIEWER="C:MultiView"
  84. AUTODELETE <delete if in batch mode>    Default is AUTODELETE
  85.            (if you don't want to automatically delete converted files, remove this tooltype)
  86. DEVICES=<devices to use for dms/dsq>    Default is DEVICES=DF0|DF1
  87.  
  88. CLI Usage:
  89.  
  90. not supported (it's an interface.  That's the point!)
  91.  
  92. Workbench Usage:
  93.  
  94. If  you want to see what is happening, I would use the CCB icon, but if you
  95. don't  need to see what is going on, just click on the CompressorControlBox
  96. icon.    The  only  difference is that the CCB icon also opens up an output
  97. shell,  so  you  can  see  what is happening.  I have noticed no noticeable
  98. speed  increase  in  NOT  opening  the  shell, so it's a matter of personal
  99. choice.
  100.  
  101. I've  tried to make it as easy to use as possible.  Just follow the 5 steps
  102. shown on the interface, and you'll be set.  In order, these are:
  103.  
  104. 1) Select Compressor.  LhA, LZX, DMS, DSQ, LhA-2-LZX, or DMS-2-DSQ
  105.  
  106.     LhA-2-LZX  and  DMS-2-DSQ perform the conversion process in the
  107.     T:  directory.    I have found that you will need about 2.5 meg
  108.     free  for converting a DMS file to an DSQ file, and about 1 1/2
  109.     times  the  size of the LhA file for converting an archive from
  110.     LhA  format  to  LZX.    If  you  don't  have  enough memory to
  111.     transform the file, I suggest assigning T: to somewhere on your
  112.     harddrive.   It will slow things down somewhat, but unless your
  113.     HD  is  REALLY  cramped,  you  should have enough room there to
  114.     perform  the  conversion.    The LhA-2-LZX and DMS-2-DSQ options
  115.     also  offer  a  'batch'  mode,  for converting many files all at
  116.     once.   Unlike the 'single file mode', batch conversion does not
  117.     show the resulting file-size difference between the original and
  118.     new  files, or offer the chance to delete one.  Select the first
  119.     file  to  convert,  hold  down the shift key, and select as many
  120.     others  as  you  wish.    Pretty easy, just like shift-selecting
  121.     icons  on  the WorkBench.  All selected files will be processed,
  122.     keeping  the  originals  intact, unless an error is encountered,
  123.     which will stop the conversion process.  Each file will be shown
  124.     in  the  'Source'  box  as  it  is  being  processed, and if the
  125.     conversion  fails,  that entry will remain shown in the box.  If
  126.     the  AUTODELETE  tooltype  is  set,  the  original  file WILL BE
  127.     DELETED  if  the conversion process is successful.  If you don't
  128.     trust me, then don't set the tooltype.
  129.  
  130. 2) Select Operation.  Compress, DeCompress, Test, View/Add Diz
  131.  
  132.     View/Add Diz works as follows.  If the file you checked doesn't
  133.     have a File_id.diz, CCB will open up a little window for you to
  134.     enter  the  description  into.   When you are finished entering
  135.     text,  hit 'ESC x' to close the window and save the File_id.diz
  136.     to  the  file.  If the file DOES have a File_id.diz attached to
  137.     it,  it  will be displayed and you will be given an opportunity
  138.     to modify it.
  139.     
  140. 3) Select Source File/Dir/Device.
  141.  
  142.     Click  on this, a requester comes up, allowing you to select the
  143.     SOURCE File/Dir/Device.  When using DMS or DSQ, a requester will
  144.     pop  up asking for the source device, such as DF0 or DF1, at the
  145.     right  time.  Don't worry, you'll know it when it happens!  Just
  146.     make  sure  there  is  a  disk  in the drive BEFORE you click on
  147.     Start!
  148.    
  149. 4)  Select Destination.
  150.  
  151.     Another requester.  When using DMS or DSQ, a requester will pop
  152.     up  asking  for  the destination device, such as DF0 or DF1, at
  153.     the  right time.  Don't worry, you'll know it when it happens! 
  154.     Just make sure there is a disk in the drive BEFORE you click on
  155.     Start!
  156.  
  157. 5) Process Selection.  Start or Reset All
  158.  
  159.     Reset All clears the current selection.
  160.  
  161.     If  you  are  DeCompressing  an LhA or LZX archive, a requester
  162.     will pop-up, asking if you would like to create a drawer to put
  163.     the  contents  into.   This keeps things from getting scattered
  164.     all  over your drive, and makes it easy to get rid of files you
  165.     decide not to keep.
  166.     
  167.  
  168. Want  more  info?  OK, you've got it.  If you select the Test operation, no
  169. need to select a destination.  Makes sense, right? 
  170.  
  171. If  using  DSQ,  I  strongly  suggest  assigning  T:  to  somewhere on your
  172. harddrive,  as  it  can use up to 2 meg of RAM while processing a file.  Of
  173. course,  if you have 3 megs or more free, don't worry about it.  The little
  174. memory  display below the title bar should give you a clue as to whether or
  175. not you need to re-assign T: to your HD
  176.  
  177. That's  it!   If you have any questions or comments, or just want to send a
  178. donation (A4000, Corvette, book, game, money, whatever) please feel free to
  179. get in touch with me at the address below.
  180.  
  181.                                 John Wells
  182.                              2595 Vonoa Drive
  183.                             Radcliff, KY 40160
  184.                           e-mail: johnw@kvnet.org
  185.  
  186.  
  187. Registration Info:
  188.  
  189. Registration  is simple.  I'm not picky.  I will accept just about anything
  190. you  consider  to  be  of  value.    For  example,  I  will gladly accept a
  191. registered  version  of  a  program  YOU  have  written in exchange for the
  192. registered  version  of Compressor Control Box.  If the exchange is handled
  193. via  e-mail,  I  will continue to send updates as they are created, with no
  194. further fee due.  Naturally, I will not turn down monetary offers, or boxes
  195. of  cookies,  a CD, whatever.  I will supply the registered version ONCE by
  196. floppy,  if  you would prefer to do it that way.  Updates will ONLY be sent
  197. out  via  e-mail.    So  be  sure  to  give me your e-mail address when you
  198. register. 
  199.  
  200.                     Greetings, Thanks, and Other Stuff
  201.  
  202.     I would like to thank those who have sent me e-mail, for the kind words
  203.     and  support (and suggestions!), especially ashley@apowell.demon.co.uk,
  204.     who was the very first to send me a message regarding CCB.
  205.     
  206.           I would also like to extend my thanks to the following:
  207.  
  208.             Ashley, for making the excellent AmigaGuide for CCB
  209.                       Stephen Davies, author of DirII
  210.                        Stefan Boberg, author of LhA
  211.                       Jonathan Forbes, author of LZX
  212.                       SDS Software, author(s?) of DMS
  213.                     Dirk Vael, author of DiskSqueeze! 
  214.                     Christian Wasner, author of PackDev
  215.                  Jay Miner for creating a REAL computer! 
  216.                   Amiga Technologies for resurrecting Amy
  217.                      VisCorp for picking up the pieces
  218.                  INOVAtronics, Inc., developers of CanDo!
  219.            Re/Y\o(/Y\ystic/X-DeSign), author of DMSDescript v1.1
  220.  
  221.  
  222.                                   HISTORY
  223.  
  224. v2.1 - 4 August 96
  225.  
  226.     Well,  improving the handling of the ToolTypes in v2.0 resulted in some
  227.     other  problems,  namely,  the  program didn't read them correctly, and
  228.     reverted  to  the  defaults!    So I REALLY fixed it this time!  I also
  229.     changed  the  way  CCB  handles  valid  floppy devices, and removed the
  230.     IGNORE ToolType.  Instead I added a new ToolType, DEVICES.  This allows
  231.     you  to  specify  the floppy-type devices that DMS and DSQ will use.  I
  232.     also  changed  the  way DMS files are converted to DSQ, it now uses the
  233.     dms.device  instead  of  DMS  itself.  Of course, this function is only
  234.     available to registered users.
  235.  
  236. v2.0 - 9 June 96
  237.  
  238.     Straightened  up  some  items  in  the  display  window,  added another
  239.     pull-down  menu item (I'm not gonna tell, you'll have to take a look!),
  240.     fixed  the  AUTODELETE  function,  removed  some  code  that  didn't do
  241.     anything, improved the handling of the ToolTypes.
  242.  
  243. v1.9 - 16 Mar 96
  244.  
  245.     Ok,  I  think  I  REALLY  fixed  the IGNORE problem, this time.
  246.     There  are  several  devices  built in that are scanned for and
  247.     removed,  I  know that there will be some left over, but that's
  248.     what  the tooltype is for.  If it still gives you problems, let
  249.     me know what the problem is, I'll try to correct it.
  250.  
  251. v1.8 - 9 Mar 96
  252.  
  253.     Fixed  some  problems with the log generator, set it to default
  254.     to  using  'MORE' if the viewer specified by the tooltype could
  255.     not  be  found.   Remember, you MUST specify a complete path to
  256.     the viewer, for exammple 'C:MultiView', not just 'MultiView'.
  257.  
  258. v1.7 - 1 Mar 96
  259.  
  260.     Added  the  tooltype  IGNORE,  which allows the user to specify
  261.     which  devices  to NOT show when using DMS/DSQ.  Just add other
  262.     devices  to  the  tooltype,  each  separated  by  '|',  such as
  263.     IGNORE=CD1|TCP|FIFO
  264.  
  265. v1.6 - 18 Feb 96
  266.  
  267.     Added a logfile, which will keep track of all actions performed
  268.     by  CCB.   It will be located in the same directory that CCB is
  269.     in,  so  it will be easy to find.  Added another pull-down menu
  270.     item, 'View CCB Log' (hotkey is Right-Amiga V).  This will call
  271.     your  default viewer, or C:MultiView if not set, to display the
  272.     log file.
  273.  
  274.     I  realized  that  I  had  forgotten  to specify how to use the
  275.     'batch'  conversion  mode for LhA-2-LZX and DMS-2-DSQ.  Here it
  276.     is.  Select the first file to convert, hold down the shift key,
  277.     and  select as many others as you wish.  Pretty easy, just like
  278.     shift-selecting icons on the WorkBench.
  279.  
  280.     Found,  and  squashed,  a  little  bug in the history function,
  281.     should work the way it's supposed to now.
  282.  
  283.     Added  checking for processor-type (680x0), so that the special
  284.     functions  of  LZX  won't  be  tried  if  the processor doesn't
  285.     support  them (sorry, 68000/010 users.  Didn't mean to alienate
  286.     you!)
  287.  
  288.     Added  another  tooltype,  AUTODELETE, which will automatically
  289.     delete  the  original  file  during  batch  conversion,  IF the
  290.     conversion had no errors.  I personally converted over 180 megs
  291.     of  DMS  files  to DSQ, with no errors at all.  And I converted
  292.     over 200 megs of LHA files to LZX, no problems there, either.
  293.  
  294. v1.5 -    12 Feb 96
  295.  
  296.         Added  'batch  mode'  to  the   LhA-2-LZX   and   DMS-2-DSQ
  297.         conversion  routines,  added  tooltype support for defining
  298.         the  Source,  Destination  and temporary T: directories, as
  299.         well  as  the  ability to define where your favorite viewer
  300.         is.    If the ToolTypes are not found, the defaults of SYS:
  301.         and  C:MultiView  will  be  used.    Moved  the  'Free Mem'
  302.         indicator  from  the window title bar to it's location next
  303.         to  the   'Select   Compressor'   text   for   legibility. 
  304.         Re-arranged  the  'History'  in  this document, to show the
  305.         latest info at the top, removed the use of DLDiz (no longer
  306.         needed), and enhanced the error-detection routines.
  307.  
  308. v1.4 -    30 Jan 96
  309.  
  310.         Ok,  cleaned  up the GUI, think I have the docs pretty well
  311.         squared  away  now.    I  have (I think) complied with Dirk
  312.         Vael's  request  to  dump  xDM  and   switch   support   to
  313.         DiskSqueeze!,  I  hope  he likes the way it has turned out.
  314.         Fixed  a  bug  in  the  creation  of  a  new   drawer   for
  315.         decompressing  lha  and  lzx  archives (thanks for spotting
  316.         that,  Ashley!),  fixed  the  constant  re-drawing  of  the
  317.         program window, added the ability to delete the original or
  318.         the new when converting from lha-to-lzx and when converting
  319.         from  DMS-to-DSQ.  Added a bunch of progress indicators, so
  320.         you  won't  think  things are frozen when converting files,
  321.         fixed  the  memory  indicator  (I  hope),  added a means of
  322.         assigning  T:  to  the hard drive if low on memory, fixed a
  323.         serious  bug in the DMS and DSQ routines (I won't tell what
  324.         it  was.   If you found it, you know what it was).  Changed
  325.         the  'Abort'  button  to  'Reset All', which is what it was
  326.         originally  supposed  to do (and now does).  There might be
  327.         more,  but  after  3  days sitting in front of Amy, I can't
  328.         seem  to remember!  I would like to especially thank Ashley
  329.         for doing the AmigaGuide for CCB.  Looks great!
  330.  
  331. v1.31 - 27 Jan 96
  332.  
  333.         This  was  an emergency release, disabling the xDM portions
  334.         of  CCB.   I received a message from the originator of xDM,
  335.         Dirk  Vael,  asking  me to remove xDM from the program.  In
  336.         haste,  I simply disabled those functions pertaining to xDM
  337.         and sent it out, to replace the v1.3 release.  I'll get the
  338.         GUI and docs cleaned up for the next release.
  339.  
  340. v1.3 - 20 Jan 1996
  341.  
  342.         Finally  found  a  way  to  make  LhA  and  LZX  compress a
  343.         directory  and  include  the selected path ONLY, as well as
  344.         the  .info for the drawer (if it exists).  What this means,
  345.         is  that  you will no longer have files that un-compress to
  346.         something   like:    WorkBench:Games/FavoriteOfAllTime/blah
  347.         Instead,  if  you  had  elected  to   compress   the drawer
  348.         'FavoriteOfAllTime/',  containing  'blah' and such, it will
  349.         actually  only  have  the path of 'FavoriteOfAllTime/blah',
  350.         just  like it should!  Also, I finally got around to fixing
  351.         up  some  of the pull-down menus, take a look at them.  One
  352.         more thing.  I found the program 'DMSDescript', which means
  353.         that you can now View/Add a File_id.diz to DMS files.
  354.  
  355. v1.3 - FIRST REGISTERED VERSION
  356.  
  357.         I  decided to make the LhA-2-LZX and DMS-2-xDM options only
  358.         available  to registered users, have to give them some kind
  359.         of  benny  for  registering!    Since  v1.0  - v1.2 did not
  360.         support  this  repacking option, it looks like v1.3 will be
  361.         the  first  to  give  the  un-registered users something to
  362.         think  about.  I find the option VERY handy, since it is SO
  363.         EASY TO USE!  So come on, folks, go ahead and register.  It
  364.         really is worth it!  :)
  365.  
  366. v1.2 - 14 Jan 1996
  367.  
  368.         Spruced  up  the  appearance  of  the GUI somewhat, added a
  369.         pop-up  requester  to the DeCompress option of LhA and LZX,
  370.         to  ask  the  user if a drawer should be created to put the
  371.         contents  into.  Straightened up some code, got rid of some
  372.         excess,  added  the  'About' menu item.  Just little stuff,
  373.         really.  Oh, and I cleaned up this readme, too!
  374.         
  375. v1.1 - 9 Jan 1996 
  376.  
  377.         Finally  found  a  way  to  fix  the  niggling problem with
  378.         selecting  the device to use for DMS and xDM.  The user can
  379.         now select ANY floppy-type device for use by CCB.
  380.  
  381.         Added  a  'history'  function  to  the   source/destination
  382.         requesters,  so  that  the  last directory used will be the
  383.         default (hope that is what you had in mind, Ashley!)
  384.  
  385.         Fixed  the  'View/Add  Diz'  option,  can  now   view   the
  386.         File_id.diz of LZX, LhA, DMS, and xDM archives, and can add
  387.         a  File_id.diz  to LZX, LhA, and xDM files.  Sorry, nothing
  388.         for DMS (yet!).
  389.  
  390.         Added  a  Memory display to the title bar, good for keeping
  391.         track of just how much ram you have left after crunching up
  392.         several disks or directories.
  393.  
  394.  
  395. v1.0 - 1 Jan 1996
  396.  
  397.       Initial release
  398.  
  399.